home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / othernet / fidonet / ff_1134b / filefind.txt < prev   
Text File  |  1996-12-08  |  11KB  |  304 lines
  1.  
  2.                  File-Finder v1.13pl4 áeta (8 Dec 1996)
  3.  
  4.                        AllFix File Finder System
  5.                         FreeWare - Don't buy it!
  6.  
  7.                     (C)opyright 1993-1996 M.J. Matts
  8.  
  9.                        Written by M.J. Matts, new
  10.                        development by Darren Hook
  11.  
  12.  
  13. What is File-Finder?
  14. ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  15.  An easy to use network utility to enable users to search for the 
  16.  existance and location of files simply by sending out a networked 
  17.  message. It offers support for many varied formats of file description 
  18.  data files used by many BBS packages.
  19.  
  20.  
  21. How?
  22. ÿÿÿÿ
  23.  To use File-Finder you must create a config file (or edit the example) 
  24.  named FILEFIND.CFG which must reside in the same folder as the main 
  25.  FILEFIND.TOS file. This config file will enable File-Finder to know 
  26.  where to search for files, what information about your system will be 
  27.  placed into replies to enable a user to easily access your system 
  28.  along with other things such as paths etc..
  29.  
  30.  The following are all the commands available for use within the config 
  31.  file:
  32.  
  33.  
  34.  SYSOP <your name>
  35.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  36.  Used for information in replies.
  37.  
  38.  Example: Sysop Mark Matts
  39.  
  40.  
  41.  SYSTEM <your BBS or mail system's name>
  42.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  43.  Used for information in replies.
  44.  
  45.  Example: System System ST
  46.  
  47.  
  48.  LOCATION <your location>
  49.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  50.  Used for information in replies.
  51.  
  52.  Example: Location Leicester, UK
  53.  
  54.  
  55.  PHONE <your telephonr number>
  56.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  57.  Used for information in replies.
  58.  
  59.  Example: Phone +44 (0)533 413443
  60.  
  61.  
  62.  BAUD <your systems baud rate>
  63.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  64.  Used for information in replies.
  65.  
  66.  Example: Baud 1200/2400/9600
  67.  
  68.  
  69.  TIMES <your online times>
  70.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  71.  Used for information in replies.
  72.  
  73.  Example: Times 10pm to 7am
  74.  
  75.  
  76.  ADDRESS <network address>
  77.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  78.  Used for information in replies. You can define upto 10 different 
  79.  addresses.
  80.  
  81.  Example: Address 90:100/101.0
  82.  
  83.  
  84.  MSGBASE <path & filename (no extender) to File-Finder msg base>
  85.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  86.  Tells File-Finder which message base to scan for File-Finder messages 
  87.  and also where to reply to them. **NOTE** Please make sure this 
  88.  message base has been setup specifically to operate as a file finder 
  89.  system. On the NeST network the base used for this purpose is called 
  90.  N_ALLFIX and should be available from most mailer systems. By defining 
  91.  multiple message bases (upto 10) you can run File-Finder on different 
  92.  networks... See config file for example of multiple msgbase commands.
  93.  
  94.  Example: MsgBase F:\NESTWARE\FILEFIND\MSGBASE\N_ALLFIX
  95.  
  96.  
  97.  FINDERNAME <name of TO: field to respond to>
  98.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  99.  Tells File-Finder what to check for and react to when scanning for 
  100.  request messages. You can define upto 10 different File-Finder names. 
  101.  Please note that this command is *NOT* case sensitive so ALLFIX is 
  102.  treated the same as allfix. ALLFIX and FILEFINDER are default settings 
  103.  so this command is only needed when other finder names are to be used.
  104.  
  105.  Example: Findername AllFix
  106.  
  107.  
  108.  LOGFILE <path & filename to log File to use>
  109.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  110.  Tells File-Finder which file to use for logging it's activity. A 
  111.  BinkleyTerm format is used with FFDR as the text identifier. Log 
  112.  entries will only be made if File-Finder actually does anything.
  113.  
  114.  Example: LogFile F:\BINKLEY\BINKLEY.LOG
  115.  
  116.  
  117.  MAXDESC <maximum number of description to allow in a reply>
  118.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  119.  Forces File-Finder not to include any more than the given number of 
  120.  descriptions in a reply message. This should hopefully avoid any 
  121.  excessively large messages being sent into the networks. The maximum 
  122.  setting is 15 which is also the default so this option is only of use 
  123.  if you wish to cut down the limit since you cannot increase it above 
  124.  15. This limit also applies to replies sent to a description request.
  125.  
  126.  Example: MaxDesc 10
  127.  
  128.  
  129.  LOCK <filename>
  130.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  131.  Allows you to lock a named file from being included in a File-Finder 
  132.  reply. You can define upto 100 locked files.
  133.  
  134.  Example: Lock PRIVATE.LZH
  135.  
  136.  
  137.  FROMSYSOP
  138.  ÿÿÿÿÿÿÿÿÿ
  139.  All replies sent out from your system will be addressed from your 
  140.  sysop name as defined by the SYSOP command instead of the default 
  141.  File-Finder.
  142.  
  143.  
  144.  FROMSYSTEM
  145.  ÿÿÿÿÿÿÿÿÿÿ
  146.  All replies sent out from your system will be addressed from your 
  147.  system name as defined by the SYSTEM command instead of the default 
  148.  File-Finder.
  149.  
  150.  
  151.  SCANALL
  152.  ÿÿÿÿÿÿÿ
  153.  Forces File-Finder to scan the entire message base each time it is run 
  154.  rather then from the last read message.
  155.  
  156.  
  157.  ACCESS (followed by parameters relevant to your BBS package)
  158.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  159.  The first parameter will tell File-Finder which path to search for 
  160.  files which match the requested filename. You can define upto 300 
  161.  different paths. The parameters enclosed in the square & curly 
  162.  brackets are optional and is only used for information purposes and 
  163.  may differ depending on the BBS setting used. If a file is found in 
  164.  the path given it will be listed as being in the area defined within 
  165.  the square brackets. Please refer to the above BBS commands which will 
  166.  be suitable for you.
  167.  
  168.  Example: Access I:\COMMS\ [Communications Software] {comms}
  169.  
  170.  
  171.  The following commands each make File-Finder look for different 
  172.  description files which are used by the relevant BBS package named. 
  173.  You may mix the BBS name commands if your system uses more than just 
  174.  one type. Depending on the type of BBS named the format of the ACCESS 
  175.  command will be slightly different so please take the time to read 
  176.  which format your setup uses.
  177.  
  178.  
  179.  QUICKBBS
  180.  ACCESS <path to file area> <[Area description]>
  181.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  182.  This keyword will make File-Finder search a FILES.BBS file (in 
  183.  QuickBBS format) in the path defined by the first parameter of the 
  184.  relevant ACCESS commands.
  185.  
  186.  Example: QuickBBS
  187.           Access I:\COMMS\ [Communications Software]
  188.  
  189.  
  190.  TURBO <path to *.FIL files>
  191.  ACCESS <path to file area> <[Area description]> <{FIL name}>
  192.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  193.  This keyword will make File-Finder search the given path for any FIL 
  194.  files named for each area. (TurboBoard v2 format)
  195.  
  196.  Example: Turbo H:\TURBO\DATA\
  197.           Access I:\COMMS\ [Communications Software] {comms}
  198.  
  199.  
  200.  FOREM
  201.  ACCESS <path to file area> <[Area description]> <{DIR name}>
  202.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  203.  This keyword will make File-Finder search in the path given in each 
  204.  access command for the named DIR file for each area.
  205.  
  206.  Example: Forem
  207.           Access I:\COMMS\ [Communications Software] {comms}
  208.  
  209.  
  210.  STKEEP
  211.  ACCESS <path to file area> <[Area description]>
  212.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  213.  This keyword will make File-Finder search in the FILES folder which 
  214.  should be in the path defined by the first parameter of the relevant 
  215.  ACCESS commands.
  216.  
  217.  Example: STKeep
  218.           Access I:\COMMS\ [Communications Software]
  219.  
  220.  
  221.  EXPRESS
  222.  ACCESS <path to file area> <[Area description]>
  223.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  224.  This keyword will make File-Finder search in the DESC folder which 
  225.  should be in the path defined by the first parameter of the relevant 
  226.  ACCESS commands.
  227.  
  228.  Example: Express
  229.           Access I:\COMMS\ [Communications Software]
  230.  
  231.  
  232.  WIZFILE <path & filename of WIZfile description file>
  233.  ACCESS <path to file area> <[Area description]>
  234.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  235.  This keyword will make File-Finder search the file list created by 
  236.  WIZfile, however, the file must be in the format produced by pre 
  237.  WIZfile v1.30.
  238.  
  239.  Example: WIZFile H:\WIZFILE\ALLFILE.TXT
  240.           Access I:\COMMS\ [Communications Software]
  241.  
  242.  
  243.  NEWWIZFILE <path & filename of WIZfile description file>
  244.  ACCESS <path to file area> <[Area description]>
  245.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  246.  This keyword will make File-Finder search the new format of file list 
  247.  created by WIZfile v1.03 using the -F option.
  248.  
  249.  Example: NewWIZFile H:\WIZFILE\FILES.BBS
  250.           Access I:\COMMS\ [Communications Software]
  251.  
  252.  
  253.  RATSOFT <path to main RATSoft folder (CONFIG.DAT)>
  254.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  255.  Using this command you will NOT need to define any ACCESS commands, 
  256.  all the ACCESS paths and area descriptions will be taken directly from 
  257.  the RATSoft environment which is found by using the path after this 
  258.  command.
  259.  
  260.  Example: RatSoft H:\RATSOFT\
  261.  
  262.  
  263.  RATLEVEL <maximum file/area level to scan>
  264.  ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
  265.  Only to be used in association with RATSOFT. Limits the files/areas to 
  266.  be scanned according to the access level set. Default is 254 (ie 255 
  267.  sysops only areas will be ignored).
  268.  
  269.  Example: RatLevel 200
  270.  
  271.  
  272.  PLEASE NOTE. IF YOU WOULD LIKE TO HAVE YOUR BBS PACKAGE SUPPORTED 
  273.  PLEASE SEND ME THE STRUCTURES AND AN EXAMPLE OF ANY FILE(S) WHICH HOLD 
  274.  THE FILE DESCRIPTIONS PLUS OTHER INFO WHICH WILL HELP ME.
  275.  
  276.  
  277.  That's all there is to it! You can specify both any of the BBS name 
  278.  commands if your system uses a mixture of both formats, ideal for 
  279.  multiBBS systems. A check will be made for both file formats in each 
  280.  area and the description will be taken from the first one found.
  281.  
  282.  If File-Finder writes a reply to any File-Find enquiries it will exit 
  283.  with an errorlevel of 1 therefore allowing you to run your exporter if 
  284.  needed. An errorlevel of 0 is used in all other instances.
  285.  
  286.  
  287. Support!
  288. ÿÿÿÿÿÿÿÿ
  289.  As from version 1.09 àlpha, I have permission from Mark Matts to 
  290.  continue development of File-Finder. He still retains copyright!!
  291.  
  292.  If you have any problems or ideas, please contact me, Darren Hook - 
  293.  the current developer - via any of the following addresses:
  294.  
  295.      Internet:   dhook@dcs.qmw.ac.uk
  296.                  dhook@mettav.demon.co.uk
  297.      Fidonet:    2:254/108.4@fidonet.ftn
  298.      NeST:       90:102/151.0@nest.ftn
  299.      AtariNet:   51:502/100.4@atarinet.ftn
  300.      Turbonet:   100:1011/4.0@turbonet.ftn
  301.  
  302.  Enjoy...
  303.  
  304.